This optional section defines any shortcuts Setup is to create in the Start Menu and/or other locations, such as the desktop.
Here is an example of an [Icons] section:
[Icons]
Name: "{group}\My Program"; Filename: "{app}\MYPROG.EXE"; WorkingDir: "{app}"
Name: "{group}\Uninstall My Program"; Filename: "{uninstallexe}"
The following is a list of the supported parameters:
The name and location of the shortcut to create. Any of the shell folder constants or directory constants may be used in this parameter.
Keep in mind that shortcuts are stored as literal files so any characters not allowed in normal filenames can't be used here. Also, because it's not possible to have two files with the same name, it's therefore not possible to have two shortcuts with the same name.
Name: "{group}\My Program"
Name: "{group}\Subfolder\My Program"
Name: "{userdesktop}\My Program"
Name: "{commonprograms}\My Program"
Name: "{commonstartup}\My Program"
The command line filename for the shortcut, which normally begins with a directory constant.
Filename: "{app}\MYPROG.EXE"
Filename: "{uninstallexe}"
Optional command line parameters for the shortcut, which can include constants.
Parameters: "/play filename.mid"
The working (or Start In) directory for the shortcut, which is the directory in which the program is started from. If this parameter is not specified or is blank, Windows will use a default path, which varies between the different Windows versions. This parameter can include constants.
WorkingDir: "{app}"
The hot key (or "shortcut key") setting for the shortcut, which is a combination of keys with which the program can be started.
Note: If you change the shortcut key and reinstall the application, Windows may continue to recognize old shortcut key(s) until you log off and back on or restart the system.
HotKey: "ctrl+alt+k"
Specifies the Comment (or "description") field of the shortcut, which determines the popup hint for it in Windows 2000, Me, and later. Earlier Windows versions ignore the comment.
Comment: "This is my program"
The filename of a custom icon (located on the user's system) to be displayed. This can be an executable image (.exe, .dll) containing icons or a .ico file. If this parameter is not specified or is blank, Windows will use the file's default icon. This parameter can include constants.
IconFilename: "{app}\myicon.ico"
Zero-based index of the icon to use in the file specified by IconFilename. Defaults to 0.
If IconIndex is non-zero and IconFilename is not specified or is blank, it will act as if IconFilename is the same as Filename.
IconIndex: 0
This parameter is a set of extra options. Multiple options may be used by separating them by spaces. The following options are supported:
When this flag is set, Setup will set the "Close on Exit" property of the shortcut. This flag only has an effect if the shortcut points to an MS-DOS application (if it has a .pif extension, to be specific). If neither this flag nor the dontcloseonexit flags are specified, Setup will not attempt to change the "Close on Exit" property.
When this flag is set, the installer will only try to create the icon if the file specified by the Filename parameter exists.
Same as closeonexit, except it causes Setup to uncheck the "Close on Exit" property.
Creates a special type of shortcut known as a "Folder Shortcut". Normally, when a shortcut to a folder is present on the Start Menu, clicking the item causes a separate Explorer window to open showing the target folder's contents. In contrast, a "folder shortcut" will show the contents of the target folder as a submenu instead of opening a separate window.
Folder shortcuts are only supported by Windows 2000, Me, and later. On earlier versions of Windows, Setup will fall back to creating a normal shortcut when this flag is used.
When this flag is used, a folder name must be specified in the Filename parameter. Specifying the name of a file will result in a non-working shortcut.
When this flag is set, Setup sets the "Run" setting of the icon to "Maximized" so that the program will be initially maximized when it is started.
When this flag is set, Setup sets the "Run" setting of the icon to "Minimized" so that the program will be initially minimized when it is started.
Instructs the uninstaller not to delete the icon.
When this flag is set, specify just a filename (no path) in the Filename parameter, and Setup will retrieve the pathname from the "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\App Paths" registry key and prepend it to the filename automatically.
Flags: runminimized